Service Management
Service management and control in CygNet is handled by the Remote Service Manager (RSM) service.
See the following topics for more information about using and interacting with the RSM:
- View general Service Management information
- View RSM Service Configuration File Keywords
- Use the CygNet Host Manager to:
- Configure Service Startup and Shutdown Order
- Back up the RSM
- Configure Automatic Service Recovery
- View security information for the RSM, including information about the RSM Password
- Configure and visualize CygNet Redundancy
- View the Audit Levels for the RSM
- View scripting interfaces the RSM:
- CygNet .NET API for interfacing with the RSM. Includes CygNet.API.ServiceManager and CygNet.Data.ServiceManager
- CxHmiRsm API for interfacing with the RSM using COM and ActiveX libraries. Includes CygNet RSM View Control, CxRsmCtl, and CxRsmEditor
- Use RSM command line utilities:
- RSM Control Services — controls services on a host (start, stop, restart, or report service status)
- RSM Get File — gets files from the machine running the specified RSM
Service Control Status
When an RSM is started, all services are restored to their previous operational state. When an RSM is stopped, all services running under its control are stopped. The following table describes the Status values for any service displayed in the RSM service pane of CygNet Explorer.
| Control Status | Description |
|---|---|
|
Defined |
The service has been added to the RSM but has not been started by the RSM. |
|
Ready |
A transitional state to "Starting". |
|
Starting |
A transitional state from "Ready" to "Running". |
|
Start Failed |
The start attempt failed. |
|
Misconfigured |
The Site.Service specified in the service definition does not match the configuration file (.cfg). |
|
Running |
The service is operational and running. |
|
Running on a different domain |
The service is operational and running on a domain that is different to the domain of the client. See Configuring Redundancy for more information. |
|
Failed |
The service was stopped by a means other than the RSM (for example, a stop command was issued from the service screen). |
|
Stopping |
A transitional state from "Running" to "Stopped". |
|
Stopped |
The service is stopped. |
Note: Be careful not to confuse the RSM control status of a service with the ARS operational status.
System Service
Since the RSM is the one service used to control other services, it is the only service that will appear in the Services window when running CygNet as operating system services. It can also be configured to be the only service that shows on the task bar when running CygNet as processes.
Services Base Directory
The base directory where your CygNet services are located is defined by the RSM_BASE_DIR RSM keyword. This keyword defines the absolute path to the CygNet\Services folder. When a service is added to the RSM, the path to the service’s data and executable folders must be defined relative to this base directory. This information is required by the RSM is used to start and stop other services.
More:
Configuring Service Startup Order
